Move documentation to inline comments: GtkHSV

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 65aa4939b4a2e487fc47588425e824415d1f574e..84d3c3644d28d2dec6f5abb1b7735a67fddbf0f6 100644 (file)
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -52,6 +52,7 @@ gtkhpaned.sgml
 gtkhscale.sgml
 gtkhscrollbar.sgml
 gtkhseparator.sgml
+gtkhsv.c
 gtkiconfactory.sgml
 gtkicontheme.sgml
 gtkiconview.sgml

diff --git a/docs/reference/gtk/tmpl/gtkhsv.sgml b/docs/reference/gtk/tmpl/gtkhsv.sgml
deleted file mode 100644 (file)
index ee952c9..0000000
--- a/docs/reference/gtk/tmpl/gtkhsv.sgml
+++ /dev/null
@@ -1,142 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkHSV
-
-<!-- ##### SECTION Short_Description ##### -->
-A 'color wheel' widget
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-#GtkHSV is the 'color wheel' part of a complete color selector widget.
-It allows to select a color by determining its HSV components in an
-intuitive way. Moving the selection around the outer ring changes the hue,
-and moving the selection point inside the inner triangle changes value and
-saturation.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<variablelist>
-  <varlistentry>
-    <term>#GtkColorSelection</term>
-    <listitem>a complete color selection widget</listitem>
-  </varlistentry>
-  <varlistentry>
-    <term>#GtkColorSelectionDialog</term>
-    <listitem>a color selection dialog</listitem>
-  </varlistentry>
-</variablelist>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkHSV ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### SIGNAL GtkHSV::changed ##### -->
-<para>
-
-</para>
-
-@hsv: the object which received the signal.
-
-<!-- ##### SIGNAL GtkHSV::move ##### -->
-<para>
-
-</para>
-
-@hsv: the object which received the signal.
-@arg1: 
-
-<!-- ##### FUNCTION gtk_hsv_new ##### -->
-<para>
-
-</para>
-
-@void: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_hsv_set_color ##### -->
-<para>
-
-</para>
-
-@hsv: 
-@h: 
-@s: 
-@v: 
-
-
-<!-- ##### FUNCTION gtk_hsv_get_color ##### -->
-<para>
-
-</para>
-
-@hsv: 
-@h: 
-@s: 
-@v: 
-
-
-<!-- ##### FUNCTION gtk_hsv_set_metrics ##### -->
-<para>
-
-</para>
-
-@hsv: 
-@size: 
-@ring_width: 
-
-
-<!-- ##### FUNCTION gtk_hsv_get_metrics ##### -->
-<para>
-
-</para>
-
-@hsv: 
-@size: 
-@ring_width: 
-
-
-<!-- ##### FUNCTION gtk_hsv_is_adjusting ##### -->
-<para>
-
-</para>
-
-@hsv: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_hsv_to_rgb ##### -->
-<para>
-
-</para>
-
-@h: 
-@s: 
-@v: 
-@r: 
-@g: 
-@b: 
-
-
-<!-- ##### FUNCTION gtk_rgb_to_hsv ##### -->
-<para>
-
-</para>
-
-@r: 
-@g: 
-@b: 
-@h: 
-@s: 
-@v: 
-
-

diff --git a/gtk/gtkhsv.c b/gtk/gtkhsv.c
index 7c67fa50a2ddfaeeb73aa8cb1217cfe6bc7b6582..913f6dfdffc393654d89561df0f1aaba5497bfb7 100644 (file)
--- a/gtk/gtkhsv.c
+++ b/gtk/gtkhsv.c
@@ -40,6 +40,21 @@
 #include "gtktypebuiltins.h"
 #include "gtkintl.h"
 
+
+/**
+ * SECTION:gtkhsv
+ * @Short_description: A 'color wheel' widget
+ * @Title: GtkHSV
+ * @See_also: #GtkColorSelection, #GtkColorSelectionDialog
+ *
+ * #GtkHSV is the 'color wheel' part of a complete color selector widget.
+ * It allows to select a color by determining its HSV components in an
+ * intuitive way. Moving the selection around the outer ring changes the hue,
+ * and moving the selection point inside the inner triangle changes value and
+ * saturation.
+ */
+
+
 /* Default width/height */
 #define DEFAULT_SIZE 100